home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / mm_bat10.zip / MB.DOC < prev    next >
Text File  |  1989-12-10  |  17KB  |  320 lines
  1. Document for MicroMacroBat....................................................
  2.  
  3. MB.EXE is a program which when run with an argument on the command line, from
  4. either the DOS prompt or within a batch file, performs the operations specified
  5. by that argument.  For example, by typing or placing this line in a batch
  6. file or on the command line:
  7.  
  8. MB BOX/1/1/12/80/1/112
  9.  
  10. MicroMacroBat will perform the operation specified by the argument
  11. BOX/1/1/12/80/1/112. The argument tells MicroMacroBat to place a BOX with the
  12. upper left corner at row 1, column 1, the lower right corner at row 12,
  13. column 80, use the single line box character and make the color black on
  14. white.
  15.  
  16. MicroMacroBat can be a very handy extention to your batch file writing tools
  17. without having to learn a new batch-file-writing language or performing
  18. a compilation.
  19.  
  20. MB.EXE can be tucked away in your utilities directory with a "path" pointing
  21. to it.  MicroMacroBat calls may be intermixed with the batch file routines you
  22. normally use without any further consideration other than proper syntax usage.
  23.  
  24. MicroMacroBat will have many uses:
  25.  
  26. *             In your AUTOEXEC.BAT files.
  27. *             In distribution disc BAT files for hard drive installations.
  28. *             In BAT files for making file backups.
  29. *             In BAT files for demonstration programs and slide shows.
  30. *             For Shareware distributors GO files.
  31. *             BLOADable screen design.  See note 3 under REGISTRATION.
  32.  
  33. DEMO.BAT is a batch file which demonstrates some of the routines and contains
  34. some important remarks.
  35.  
  36. NOTE:  In order that MB can load and execute as quickly as possible, syntax
  37. .      and error checking are non-existent.  Make no errors and you will have
  38. .      no problems.
  39.  
  40. The ONLY legal argument separator is the "/".  DO NOT use anything else.
  41. Either upper or lower case text is acceptable.  Remember, each line is to
  42. be prefixed with MB, followed by a space and the argument, ie:
  43.  
  44. .                        MB BOX/1/1/12/80/1/31
  45.  
  46. The following is a list of supported arguments, their proper syntax and an
  47. explanation of what the operation does.
  48.  
  49.  
  50. BOX/BR/BC/ER/EC/CHARACTER/COLOR/C       Draws a box where BR is the beginning
  51. .                                       row, BC the beginning column, ER the
  52. .                                       ending row, EC the ending column where
  53. .                                       BR < ER, BC < EC and COLOR < 256.
  54. .                                       CHARACTER is either 1 or 2 indicating
  55. .                                       a single or double line box.  COLOR
  56. .                                       is a single value representing the
  57. .                                       foreground and background colors.  See
  58. .                                       the single color chart below.  The
  59. .                                       values for   BR,  BC,  ER  and  EC
  60. .                                       should be within the allowable limits
  61. .                                       as dictated by the lines/columns mode
  62. .                                       of your monitor.  Appending /C to the
  63. .                                       argument clears the inside of the box
  64. .                                       to the background color specified in
  65. .                                       the COLOR argument.
  66. .                           Example:    BOX/1/5/12/75/1/79 draws a single-line
  67. .                                       box with the upper left corner at row
  68. .                                       1, column 5, the lower right corner at
  69. .                                       row 12 column 75 in bright white on
  70. .                                       red and not cleared.
  71.  
  72. CLEARSCR/BR/BC/ER/EC/COLOR              Clears an area of the screen where BR,
  73. .                                       BC, ER, EC and COLOR have the meanings
  74. .                                       as described above.
  75. .                           Example:    CLEARSCR/1/5/12/75/31
  76.  
  77. BLOAD/FILENAME$                         BLOADS a file into video memory as
  78. .                                       the BASIC's BLOAD command.  The area
  79. .                                       of video memory the file is loaded into
  80. .                                       is automatically determined by the
  81. .                                       monitor in use.  This command is for
  82. .                                       "slide shows" of predetermined screen
  83. .                                       files made with Basic's BSAVE or a
  84. .                                       screen capture utility.
  85. .                           Example:    BLOAD/MAINMENU.SCR
  86.  
  87. FILLSCRN/BR/BC/ER/EC/COLOR/ASCII        Fills the screen with the character
  88. .                                       represented by the value ASCII.  BR,
  89. .                                       BC, ER, EC and COLOR are as previously
  90. .                                       described.
  91. .                           Example:    FILLSCRN/1/5/12/75/30/45 will fill the
  92. .                                       described area with dashes colored
  93. .                                       yellow on blue.
  94.  
  95. PAINT/BR/BC/ER/EC/COLOR                 Paints the screen without disturbing
  96. .                                       the existing text.
  97. .                           Example:    PAINT/1/5/12/75/7
  98.  
  99. OCPRINT/ROW/COLUMN/TEXT$/COLOR          Same as PRINT, below, except that
  100. .                                       printing takes place slowly; one
  101. .                                       character at a time, for effect.
  102.  
  103. PRINT/ROW/COLUMN/TEXT$/COLOR            Rapidly prints TEXT$ in COLOR at the
  104. .                                       ROW/COLUMN.  TEXT$ will be displayed
  105. .                                       exactly as entered, including quotes
  106. .                                       if used.  Extended ASCII characters
  107. .                                       may be displayed. The routine writes
  108. .                                       to video memory; no line feed issued.
  109. .                           Example:    PRINT/5/1/display these words/31
  110.  
  111. CURSOROFF                               Turns the cursor off.
  112.  
  113. CURSORON                                Turns the cursor on.
  114.  
  115. LOCATE/ROW/COLUMN                       Locates the cursor at ROW/COLUMN.
  116. .                                       Handy if you want to use the ECHO
  117. .                                       command.  Printing by DOS will begin
  118. .                                       at the cursor position.
  119. .                           Example:    LOCATE/1/1
  120.  
  121. WAIT                                    Suspends operation and waits for a
  122. .                                       keypress.
  123.  
  124. CHIME/WHICHONE                          Makes a chime-like tone.  WHICHONE
  125. .                                       must be in the range of 1 to 10.
  126. .                           Example:    CHIME/7
  127.  
  128. SLEEP/SECONDS                           Suspends operation until SECONDS
  129. .                                       seconds elapses.
  130. .                           Example:    SLEEP/4
  131.  
  132. STUFF/TEXT$                             Stuffs text into the keyboard buffer,
  133. .                                       appending an <ENTER> keypress.
  134. .                                       To simulate pressing <ENTER>, simply
  135. .                                       use STUFF without parameters.  TEXT$
  136. .                                       CANNOT be more than 15 characters.
  137. .                           Example:    STUFF/Y
  138.  
  139. USCROLL/BR/BC/ER/EC/TIMES               Provides for scrolling of a selected
  140. DSCROLL/BR/BC/ER/EC/TIMES               area of the screen, either Up, Down,
  141. LSCROLL/BR/BC/ER/EC/TIMES               Left or Right, TIMES times.
  142. RSCROLL/BR/BC/ER/EC/TIMES
  143. .                           Example:    LSCROLL/1/1/12/80/4
  144.  
  145. FADE/COLOR                              Provides for a screen disolve to COLOR.
  146. .                           Example:    FADE/64
  147.  
  148. BIG/TEXT/CHR/R/C/COLOR                  Prints large block text; 3 rows, 10
  149. .